home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / telecom / term_4.1 / extras / hydracom / amiga.notes next >
Text File  |  1994-11-17  |  4KB  |  74 lines
  1. HYDRA protocol sample implementation, Amiga port rev.2 by
  2.  
  3.     Olaf Barthel
  4.     Brabeckstrasse 35
  5.     D-30559 Hannover
  6.  
  7.     eMail: olsen@sourcery.han.de
  8.  
  9. The Amiga support modules are freely distributable. For further information
  10. on   the   remaining  distribution  refer  to  the  files  `hydra.asc'  and
  11. `hydra.doc'.
  12.  
  13. Many  thanks  to  James  McOrmond  who supplied the HYDRA source code. This
  14. program  was  compiled using the SAS/C compiler, it requires Kickstart 2.04
  15. or higher to run.
  16.  
  17.                                 *
  18.  
  19. What is HYDRA?
  20. ==============
  21. HYDRA  is  a  bidirectional  file  transfer protocol designed by Joaquim H.
  22. Homrighausen  and  Arjen  G.  Lentz  similar to Bimodem, a proprietary file
  23. transfer protocol. It originated in the PC world and, as far as I know, has
  24. been ported only to the Atari ST yet. This distribution adds an Amiga port.
  25. The HYDRA protocol can send and receive data at the same time and also adds
  26. a chat option.
  27.  
  28.  
  29. What about the source code?
  30. ===========================
  31. The  source code included in this distribution was edited slightly to allow
  32. the   Amiga   implementation  to  work  properly.  The  original  code  was
  33. busy-polling  keyboard  and  serial  line,  a  feature  which  needed to be
  34. replaced  by  multitasking  friendly code on the Amiga side. The Amiga port
  35. tries  to  emulate the asynchronous serial I/O code the original PC version
  36. of the HYDRA protocol sample implementation.
  37.  
  38.  
  39. What about the documentation?
  40. =============================
  41. The  file  called  `hydra.doc',  to  be  found  in  the  `source' directory
  42. describes the HYDRA sample protocol implementation in detail. Refer to this
  43. file for more information on the program.
  44.  
  45.  
  46. Differences between the Amiga port and the original program 
  47. ===========================================================
  48. The  original implementation did not support the "DEVICE" keyword which was
  49. added to the Amiga port in order to allow third party serial device drivers
  50. to  be used. The split-screen technique used by the original implementation
  51. was  replaced  by  multiple console windows. Pull-down menus partly replace
  52. the  odd  keyboard  commands supported by the original implementation, i.e.
  53. some keyboard commands work, some don't. There is no Fossil support in this
  54. implementation  ;-)  All the features of the original implementation should
  55. work,  although  some  may  not  make  much sense on the Amiga. There is no
  56. separate HydraCfg program.
  57.    Where  I  needed to make changes to the source code my tag "/* OLSEN */"
  58. indicates where to look for changes.
  59.  
  60. What's different in revision 2 of this port?
  61. ============================================
  62. I  had  overlooked some MS-DOS dependancies in the source code, namely path
  63. and  file  name  lengths  which used to be limited to 13 and 90 characters,
  64. respectively. Where such restrictions were obvious they were removed.
  65.    HydraCom  now  offers an interface to the forthcoming new `term' release
  66. and  in  fact  any  other  terminal program that provides the same hooks as
  67. `term'.  If  you  give  the  name  of the ARexx port `term' has open as the
  68. device  name (i.e. "device TERM") HydraCom will try to interface to `term'.
  69. If  successful,  HydraCom will take over serial device processing, blocking
  70. `term'  access  to the serial driver. When HydraCom is in possession of the
  71. serial  driver  you  may  transfer files as usual, but remember that `term'
  72. itself  will  be  disabled  while  HydraCom is running. When finished, quit
  73. HydraCom, this will return control back to `term'.
  74.